ZK Loader
DHtmlLayoutServlet
Location: WEB-INF/web.xml
[Required] Class: DHtmlLayoutServlet
ZK Loader is a servlet used to load ZUML pages when the Web server receives URL requests sent by the users.
Notice that you must specify load-on-startup
since many other servlets depend on the ZK loader.
<load-on-startup>1</load-on-startup>
Here is a complete sample.
The Initial Parameters
update-uri | [Required]
For example, if the ZK AU engine is mapped to Note: if the servlet container is used with other Web server, like Apache, you have to map this update URI to the servlet container (in additions to |
resource-uri |
Since 9.5.0 [Optional] It specifies the URI which the ZK Resource engine is mapped to. For example, if the ZK Resource engine is mapped to Note: if the servlet container is used with other Web server, like Apache, you have to map this resource URI to the servlet container (in additions to |
compress | [Optional][Default:true ]
|
log-level | [Optional]
It specifies the default log level for Possible values: |
Map URL to ZUML pages
It is suggested to map this servlet to the zul
and zhtml
extensions as shown below to process ZUML pages. It is OK if you want to prefer to use xul
and html
as the extension; just map them to ZK Loader too.
<servlet>
<description>ZK loader for evaluating ZUML pages</description>
<servlet-name>zkLoader</servlet-name>
<servlet-class>org.zkoss.zk.ui.http.DHtmlLayoutServlet</servlet-class>
<init-param>
<param-name>update-uri</param-name>
<param-value>/zkau</param-value>
</init-param>
<load-on-startup>1</load-on-startup><!-- MUST -->
</servlet>
<servlet-mapping>
<servlet-name>zkLoader</servlet-name>
<url-pattern>*.zul</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>zkLoader</servlet-name>
<url-pattern>*.zhtml</url-pattern>
</servlet-mapping>
Here is a complete sample.
Map URL to Richlets
Assume you have a richlet named foo.FooRichlet
. Then, you could configure it as follows.
First, declare the richlet:
<richlet>
<richlet-name>Foo</richlet-name>
<richlet-class>foo.FooRichlet</richlet-class>
</richlet>
Second, map the richlet to any number of URL you want:
<richlet-mapping>
<richlet-name>Foo</richlet-name>
<url-pattern>/foo</url-pattern>
</richlet-mapping>
<richlet-mapping>
<richlet-name>Fest</richlet-name>
<url-pattern>/some/more/*</url-pattern>
</richlet-mapping>
Notice that, by default, richlets are disabled. To enable them, add the following declaration to web.xml
. Once enabled, you can add as many as richlets as you want without modifying web.xml
any more. Of course, url-pattern
could be any pattern you prefer.
<servlet-mapping>
<servlet-name>zkLoader</servlet-name>
<url-pattern>/zk/*</url-pattern><!-- any pattern you prefer -->
</servlet-mapping>
Then, you can visit http://localhost:8080/PROJECT_NAME/zk/foo to request the richlet.
The URL specified in the url-pattern
element must start with /
. If the URI ends with /*
, then it is matched to all request with the same prefix. To retrieve the request's actual URL, you can check the value returned by the Page.getRequestPath.
Version History
Version | Date | Content |
---|---|---|